Sent Property (Message Object)
The Sent
property is TRUE if the message has been sent through the MAPI system.
Read/write.
Syntax
objMessage.Sent
Data Type
Boolean
Remarks
In general,
there are three different kinds of messages: messages that get sent, messages
that get posted, and messages that get saved. Messages that get
sent are characterized by traditional e-mail messages sent to a recipient or
public folder. Messages that get posted are characterized by messages created
in a public folder. Messages that get saved are characterized by messages that
are created and saved without either sending or posting.
For all three
kinds of messages, you use the Submitted, Sent, and Unread
properties and the Send or Update methods.
The following
table summarizes the use of the message properties and methods for these three
kinds of messages.
|
Kind of
message |
Method |
Submitted
property |
Sent
property |
Unread
property |
|
Gets sent |
Send |
Send method sets TRUE |
Spooler
sets TRUE |
Spooler
sets TRUE |
|
Gets posted |
Update |
Application
sets FALSE |
Application
sets TRUE |
Application
sets TRUE |
|
Gets saved |
Update |
Application
sets FALSE |
Application
sets FALSE |
Application
sets TRUE |
For messages
that get sent, the Sent property can be written until the time that you
call the Send or Update method. Note that changing the Sent
property to TRUE does not cause the message to be sent. Only the Send method
actually causes the message to be transmitted. After you call the Send
method, the messaging system controls the Sent property and changes it
to a read-only property.
A common use
for writing a value to the Sent property is to set the property to FALSE
so that an electronic mail system can save pending, unsent messages in an
Outbox folder, or to save work-in-progress messages in a Pending folder before
committing the messages to a public information store. Note that you can cause
an error if you set the property incorrectly.
The Sent
property is changed using the following sequence. When you call the Send
method to send a message to a recipient, the message is moved to the Outbox and
the Message object s Submitted property is set to TRUE. When the
messaging system spooler actually starts transporting the message, the Sent
property is set to TRUE.
When the
message is not sent using the Send method, the MAPI system does not
change the Sent property. For
posted and saved messages that call the Update method, you should set
the value of the Sent property to TRUE just before you post the message.
The Sent
property corresponds to the MAPI property PR_MESSAGE_FLAGS and the flag
MSGFLAG_UNSEND.
See Also
Posting
Messages to a Public Folder12A44OJ
Submitted Property (Message Object)